home *** CD-ROM | disk | FTP | other *** search
/ Chip 1996 October / CHIP 1996 oktober (CD08).zip / CHIP_CD08.BIN / scene / antiq.'96 / lamer / lammer.zip / DMP.DOC < prev    next >
Text File  |  1994-05-07  |  9KB  |  220 lines
  1.  
  2.  
  3.                                 DMP.DOC
  4.  
  5.              Documentation for the Dual Module Player v2.90
  6.  
  7.           Copyright (C) 1992,1994 Otto Chrons
  8.  
  9.  
  10.  DMP.EXE is  a program  demonstrating the  capabilities of the DSMI
  11.  programming interface (DSMI stands for Digital Sound & Music
  12.  Interface). It's a standalone module  player with  which  you can play
  13.  STM, S3M, 669, FAR and MTM files  as well  as Amiga modules (MOD or
  14.  NST). DMP is cardware so you  can freely distribute  it and I hope you
  15.  did, as long as you include this help file with the executable. If you
  16.  like the product, please send me a postcard to the address shown on the
  17.  endscreen of DMP!!
  18.  
  19.            Here is the command line syntax:
  20.  
  21.            DMP [options] [modulename] [@listfile] [options]
  22.  
  23.            Where:
  24.            ------
  25.            modulename : name of a module (wildcards *,? allowed)
  26.            listfile   : name of a file containing list of module names
  27.  
  28.            options  : -Sxxxx          set sampling rate 4000-44100
  29.                                       alternatively 4-44
  30.                       -H or -?        show help screen
  31.                       -Ix             interrupt number
  32.                       -Pxxx           port address (use 42 for PC speaker)
  33.               -Dx             DMA channel
  34.               -O              Scramble module order
  35.               -L              Inhibit looping
  36.               -M              Mono mode (SB16 & PAS)
  37.               -Q              Quality mode (on 8-bit cards only)
  38.               -Cx             Desired card where x is:
  39.                     1 for Sound Blaster
  40.                     2 for Sound Blaster Pro
  41.                     3 for PAS+
  42.                     4 for PAS16
  43.                     5 for SB16
  44.                     6 for general DAC (Covox)
  45.                     7 for Aria cards
  46.                     8 for Windows Sound System & compat.
  47.                           (like AudioTrix Pro)
  48.                     9 for Gravis Ultrasound
  49.                     10 for PC Speaker
  50.                     11 for Stereo DAC (LPT1 & 2)
  51.                     12 for Stereo-on-1 DAC
  52.               -Txxx           Buffer size xxx (0-32000)
  53.               -E              Disable extended tempos (MOD only)
  54.               -Axxx           Amplify by xxx, 31 is normal volume
  55.               -B              Disable EMS usage
  56.               -8              Force an 16-bit card into 8-bit
  57.                       mode (works with Aria, PAS16 and WSS)
  58.               -Nxx            Set default panning to xx (0-63,100)
  59.                       100 = Surround sound
  60.               -W[command]     Automatic DOS shell, executes optional
  61.                       'command'.
  62.               -Zxx          Use 25/50 row display
  63.               -X          Quiet screen mode. DMP writes nothing
  64.                       on the screen
  65.                       -G              Use non-DMA download mode for GUS
  66.  
  67.  If you use some options all the time, you can put them into an
  68.  environment variable DMP:
  69.  
  70.     Example:
  71.  
  72.  You always want to use quality mode and sampling rate of 22kHz and
  73.  mono mode, put following line into your AUTOEXEC.BAT
  74.  
  75.     SET DMP=-q -s22 -m
  76.  
  77.  NOTE!  You cannot override single letter options (-l,-o,-m,-q) with
  78.  command line parameters. All other options can be overriden.
  79.  
  80.  Alternatively you can use the CmdLine parameter in DMP.INI for same
  81.  purpose.
  82.  
  83.  You may have to  give your soundcard's IRQ  number and/or port address
  84.  if DMP fails to find them. If you don't provide both values then DMP
  85.  will assume 220h for port address, and 7 for interrupt number. Giving
  86.  wrong address  will hang  your machine,  but wrong interrupt number
  87.  only stops the playing after a second. The "/C" option is useful if you
  88.  want to use some other card, than the one DMP automatically detects.
  89.  
  90.  You don't  have  to add  any extension  to  the name,  because the
  91.  program will try  extensions MTM, AMF, STM, 669, S3M, FAR, MOD and NST
  92.  if it doesn't find the file. Note that you can supply many modulenames
  93.  and list files.
  94.  
  95.            Example:
  96.  
  97.            DMP beyond -s20 *.NST @goodmods
  98.  
  99.            goodmods is a text file containing following lines:
  100.            occ-san
  101.            stars
  102.            intro3
  103.  
  104.  DMP  will use  the  sampling  rate  of  20KHz  and  play following
  105.  modules: BEYOND.MOD,  OCC-SAN.STM, STARS.MOD, INTRO3.MOD  and all
  106.  .NST-files in the current directory.
  107.  
  108.  DMP has also a config file called DMP.INI. It should be placed in the
  109.  same directory with DMP.EXE but DMP will also find it if it's somewhere
  110.  in the PATH. See the file itself for explanations on config switches
  111.  and strings.
  112.  
  113.  You can also play modules inside archives by specifying in DMP.INI how
  114.  to extract files from the archive.
  115.  
  116.  
  117.                               Using stereo DACs
  118.  
  119.  If you have two DACs on LPT1 and LPT2 you can use them as one stereo
  120.  source with following command line:
  121.  
  122.  DMP -c11 ...
  123.  
  124.  Note that you don't have to specify port address.
  125.  
  126.  If you have a Stereo-on-1 DAC you can use it with following options:
  127.  
  128.  DMP -c12 -pXXX ...
  129.  
  130.  where XXX is the address of the DAC (LPT1 = 378)
  131.  
  132.  
  133.                                 How to use DMP
  134.  
  135.  After DMP has  loaded the first  module, it starts  to play it and
  136.  shows some information about  it. DMP displays module's  name, its file
  137.  size, the amount of  memory used for module and sampling rate.  Because
  138.  of the AMP's Intelligent Module Loader  (IML) modules  usually take
  139.  10-30% less  space. I've  seen a 244Kb module shrink into 151Kb when I
  140.  loaded it with DMP. While playing, DMP updates fields showing current
  141.  pattern, row, elapsed time, volume and sampling rate. Under these
  142.  fields are four lines showing the current status of the corresponding
  143.  tracks. Here is an example:
  144.  
  145.  ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  146.    bassdrum            │ F#2 │ 64 │               │ ■■■■■■■■■■■■■■■■■■■■■
  147.    strings7            │ D-3 │ 20 │ ARPEGGIO      │ ■■■■■■■■■■■■■■■
  148.    guitar42            │ E-2 │ 12 │ PORT.NOTE     │ ■■■■■■■■■■■
  149.    guitar44            │ G-2 │ 57 │ FINE VOL      │ ■■■■■■■■■■■■■■■■■■
  150.  ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  151.  
  152.  The first  field shows  the instrument  currently playing  on that
  153.  track. Second is the note value, third its volume and fourth indicates
  154.  what special command is running. The bar simulates a VU  meter on music
  155.  equipment, but you shouldn't take it  as  an exact  representation of
  156.  the music  level, it's there because it looks nice!
  157.  
  158.  The rest of the screen is filled with instrument names. The numbers before an
  159.  instrument name indicate the channels that instrument is playing on.
  160.  
  161.  Pressing 'H'  brings up a  quick-help showing  command line options and
  162.  keys used to control the program.
  163.  
  164.            Keys :
  165.           ────────
  166.  
  167.            P            pause module, any key resumes
  168.            1-9          turn track xx on/off
  169.            0            turn selected track on/off
  170.            D            DOS shell (write EXIT to get back)
  171.            N            load next module (if you have supplied more than one)
  172.            S            stereo mode on/off (SB Pro), default is on
  173.            F            filter on/off (SB Pro), default is off
  174.            left/right   Jump to next/previous pattern
  175.            up/down      select track
  176.            F1-F10,+,-   set volume
  177.            [,]          Set new speed
  178.            {,}          Set new tempo
  179.            V            Real/fake volume bars
  180.            L,M,R,U      Panning full left/mid/right/surround
  181.        , .          Panning left/right
  182.        Z        Switch between 25- and 50-row display
  183.        H            Help screen
  184.        ESC          exit
  185.  
  186.  Try this module player  with all the modules  you have, and if you
  187.  encounter problems with any modules, inform the author. Have fun.
  188.  
  189.  
  190.                ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  191.                 Contacting the author
  192.                ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  193.  
  194.        ┌─────────────────────────────────────────────────────────────────────┐
  195.        │                                                                     │
  196.        │   By mail:                                                          │
  197.        │   ────────                                                          │
  198.        │                                                                     │
  199.        │            Otto Chrons                                              │
  200.        │            Vaajakatu 5 K 199                                        │
  201.        │            FIN-33720 Tampere                                        │
  202.        │            FINLAND                                                  │
  203.        │                                                                     │
  204.        │   InterNet:                                                         │
  205.        │   ──────────                                                        │
  206.        │            otto.chrons@cc.tut.fi                                    │
  207.        │                                                                     │
  208.        └─────────────────────────────────────────────────────────────────────┘
  209.  
  210.     Newest version is always available at:
  211.  
  212.        ┌────────────────────────────────────────────────┐
  213.        │ R.A. LAW         +358-37-5849007           24h │
  214.        │ ftp.wustl.edu    /pub/MSDOS_UPLOADS/modplayers │
  215.        └────────────────────────────────────────────────┘
  216.  
  217.     See CABINET.DMP for a list of DMP support sites in Finland.
  218.  
  219.     See DMP.REV for revision history.
  220.